|
Posizione nel menu |
---|
Vista ad albero → Cliccare col destro sul nome del documento → Crea gruppo |
Ambiente |
Tutti |
Avvio veloce |
Nessuno |
Introdotto nella versione |
- |
Vedere anche |
Parte, Seleziona gruppo, Aggiungi al gruppo |
Un Gruppo (chiamato internamente App DocumentObjectGroup) è un contenitore per scopi generici che consente di raggruppare diversi tipi di oggetti nella Vista ad albero, indipendentemente dal tipo di dati. È usato come una semplice cartella per classificare e organizzare gli oggetti nel modello, al fine di mantenere una struttura logica. I gruppi possono essere nidificati all'interno di altri gruppi.
Lo strumento Gruppo non è definito da un particolare ambiente di lavoro, ma dal sistema base; di conseguenza lo si ritrova nella barra degli strumenti struttura, che è disponibile in tutti gli ambienti di lavoro.
Per raggruppare gli oggetti 3D come una singola unità, con l'intenzione di creare degli assiemi, utilizzare Parte.
Vari elementi all'interno di Gruppo nella vista ad albero.
Il Gruppo è internamente chiamato App DocumentObjectGroup (App::DocumentObjectGroup
class), è derivato dall'oggetto base App DocumentObject (App::DocumentObject
class), pertanto eredita tutte le sue proprietà.
Il Gruppo ha le stesse proprietà di App FeaturePython, che è l'istanza più semplice di un App DocumentObject. Ha anche le seguenti proprietà aggiuntive nell'editor di proprietà. Le proprietà nascoste possono essere visualizzate utilizzando il comando Mostra tutto nel menu contestuale dell'editor di proprietà.
Base
LinkList
): un elenco di oggetti referenziati. Per impostazione predefinita, è vuoto []
.Bool
): se il gruppo è touched o meno.
Vedere anche: Script di base per FreeCAD, e script di oggetti.
Vedi Funzione Part per le informazioni generali su come aggiungere oggetti al documento.
Un Gruppo (App DocumentObjectGroup) è creato con il metodo del documento addObject()
. Una volta che un Gruppo esiste, altri oggetti possono essere aggiunti ad esso con i metodi addObject()
o addObjects()
.
import FreeCAD as App
doc = App.newDocument()
group = App.ActiveDocument.addObject("App::DocumentObjectGroup", "Group")
obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("Part::Box", "Box")
group.addObjects([obj1, obj2])
App.ActiveDocument.recompute()
Questo App::DocumentObjectGroup
di base non ha un oggetto Proxy, quindi non può essere pienamente utilizzato per la sotto-classe.
Per la sottoclasse Python, è necessario creare un oggetto App::DocumentObjectGroupPython
.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::DocumentObjectGroupPython", "Name")
obj.Label = "Custom label"
Per esempio, un Analisi FEM è un oggetto App::DocumentObjectGroupPython
con un'icona personalizzata e proprietà aggiuntive.